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NOTICE TO USERS OF SWIPC PAPER AND CASSETTE TAPES 


In order to help reduce the time necessary to load programs through 
either a paper tape reader or an SWIPC AC-30 cassette interface, the longer 
tapes supplied from SWIPC will be furnished in a binary format instead of 
the conventional ASCII. At the beginning of each tape is a binary loader 
program that will load into the computer using the regular ASCII format. 
The program then executes itself and loads the main program in binary. 
Using this method tapes will load in approximately 1/3 normal time. When 
using a SWIPC AC-30 lock the reader in the on position and type L. For 
paper tape readers either lock the reader on or re-set the reader-on relay 
if the load stops. (the computer will send a reader off character after an 
ASCII S9 on the tape is loader in) On cassette tapes, one side will be in 
conventional ASCII (side with long leader). and one side will be in binary. 
The tapes are formatted as follows: 


BINARY LOADER | MAIN PROGRAM 
"IN ASCII s9 IN BINARY 


As the tape loads, you will see one of the following displays on your 
terminal: (either is ok) 


*L *L 
*G *2? 
* (register dump) * (register dump) 


At least 6K of memory must be installed in the machine to use the 
binary formatted tapes. (8K for 8K BASIC) 


FEATURES OF SWIPC 8K pastc © vERSIon 1.0 


* All mathematical operations are performed in BCD (Binary Coded Decimal) 


arithmetic for maximum accuracy. 


* User programs may be saved and loaded from either SWTPC AC~30 ‘Cassette 


or paper tape. 


x Most function subprograms including transcendentals are implemented. 
* String variables and arrays are allowed. 
® Most program statements may be executed in the direct mode (no statement 


numbers for immediate calculations and enhanced program debugging). 


* Most programs will run with a memory of only 12K bytes. 


* Users can call machine language programs with the USER Function. 


Notation 


In this manual square brackets ({ ] ) are used to denote options. 


statement n 
var 

exp 

rel exp 
"textstring"” 


means 
means 
means 
means 
means 


statement number 

variable name 

mathematical expression 

relational expression 

a collection of literal alpha- 
numeric characters enclosed 
by quotation marks 
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Program Structure 


A BASIC program is comprised of statements. Every statement begins 
with a statement number, followed by the statement body, and terminated 
by a carriage return. 

There are four types of statements in BASIC: 


Declarations, Assignments, Input/Output and Control. 


These statement types are described in the corresponding sections 
of this manual. 


Statements 


- Every statement must have a statement number ranging between 1 and 
9999. Do not use line number @. 


~ Statement numbers are used by BASIC to order the program statements 
sequentially. 
- In any program, a statement number can be used only once. 


- -A previously entered line may be changed by entering the same line 
number along with the desired statement. Typing a line number followed 
immediately by a Carriage Return deletes that line number. 


- Statements need not be entered in numerical order, because BASIC 
will automatically order them in ascending order. 


- A statement may contain no more than 72 characters including blanks. 


- Blanks, unless within a character string and enclosed by quotation 
marks, are not processed by BASIC, and their use is optional. 


Example: 110 LET A=B + (3.5*5E2) 
is exactly equivalent to: 
LIOLETA=B+(3.5*5E2) 


- With blanks, the statement is more readable, but takes longer to 
process; however, numbers can contain no imbedded blanks. 


Data Format 


The range of numbers that can be represented in this version of BASIC 
is: 
1.0E-99 to 9.99999999E+99 


Dis 


99 


E+99 represents 10°” while E-99 represents 10729, The E stands for 


exponent. 


There are nine digits of significance in this version of BASIC. Nun- 
bers are internally truncated (last digits dropped) to fit this precision. 


Numbers may be entered and displayed in three formats: integer, decimal 
and exponential. 


Example: 153 34.52 136E-2 


Variable Names 


Variables may be named any single alphabetic character or any single 
alphabetic character followed by a number 0 thru 9. String variables may 
be any single variable followed by $. 


Example: A, B, C, A5, X6, AS, ZS 


String Variable 


Any single letter, or subscripted letter followed by a "$". (A4$ is 
not valid). A string variable may contain a maximum of 18 characters. 


Note: A string variable reserves 18 bytes even if only one character 
is stored within it. 


Example: AS, CS, FS, A$(3), FS$(1), G$(9,9) 


Note: These are distinct from numeric variables of the same name ...For 
instance, A=3, AS="HELLO", A(3)=7, and A$(3)="GOODBYE" are all valid. 


REM 


The REM, or remark statement, is a non-executable statement which 
has been provided for the purpose of making program listings more readable. 
By generous use of REM statements, a complex program may be more easily under- 
stood, REM statements are merely reproduced on the program listing, they 
are not executed. If control is given to a REM statement, it will perform 
no operation. (It does however, take a finite amount of time to process 
the REM statement.) 


Program Preparation 


After BASIC is loaded into your system, it may be started at memory 
address 9196, At this time, BASIC will automatically determine the range 


of working storage. If you wish to limit the amount of memory BASIC uses, 
the hex value of this limit must be stored in addresses $644,. & $45 

gi, 16 16 
before entering "G 


The system is then ready to accept commands or statements. For ex- 
ample the user might enter the following program: 


150 REM DEMOSTRATION 

160 PRINT "ENTER A NUMBER"; 

170 INPUT A 

180 LET P = A*A*3,1415926 

185 PRINT 

190 PRINT "THE AREA OF A CIRCLE WITH"; 
200 PRINT "RADIUS"; A; "IS"; P 

210 STOP 


If the user wishes to insert a statement between two others, he need 
only type a statement number that falls between the other two. For example: 


183 REM THIS IS INSERTED BETWEEN 180 and 185. 


If it is desired to replace a statement, a new statement is typed 
that has the same number as the one to be replaced. For example: 


180 P=(A*A)*3.1415926 replaces previous LET statement. 


Each line entered is terminated by a Carriage Return. BASIC positions 
the print unit to the correct position on the next line. 


The control 0 and control X control characters may be used to back- 
space one character or delete a line that was typed in error. See explana- 
tion in the Commands Section. 


If the user wishes to execute the program at this point, the RUN 
command should be entered. 


Commands 


It is possible to communicate in BASIC by typing direct commands at 
the terminal device. Also, certain other statements can be directly exe- 
cuted when they are entered without statement numbers. 


Commands have the effect of causing BASIC to take immediate action. 
A typical BASIC language program, by contrast, is first entered statement 
by statement into the memory and then executed only when the RUN command 
is given. 


When BASIC is ready to receive commands, the word READY is displayed 


on the terminal device. After each entry, the system will prompt with a 
tan ; . 


Commands are typed without statement numbers. After a command has 
been executed READY will again be displayed indicating that BASIC is ready 
for more input, either another command or program statements. 


Note: The LIST, SAVE, LOAD and APPEND commands all have #N appended 
to them, where "N" is the port number where the I/O operation will 
take place (See Input/Output Commands). 


LIST statement m statement _n 


Causes the statements of the current program to be displayed on the 
user's terminal. The lines are listed in increasing numerical order by 
statement number. The display will be only statement number m, if given, 
or statements m through n, if given, or all statements if no argument is 
given. 


Examples: LIST 30 
LIST 20, 200 
LIST #7, 30, 70 
LIST #0 


RUN 


Causes the current program resident in memory to begin execution at 
the first statement number. Run always begins at the lowest statement 
number. Run resets all program parameters and initializes all variables 
to zero. 


CONT. 


Entered after a "STOP" has been encountered, or after a Control C 
(Break) has been entered. Only to be used if an error was: not encountered, 
and if the program has not been changed. 


NEW_ 

The NEW (scratch or clear) command causes working storage and all 
variables and pointers to be reset. The effect of this command is to erase 
all traces of the program from memory and to start over. 


SAVE 


Causes the program in memory to be saved on either a SWIPC AC-30 
cassette interface or a paper tape punch. Control commands are output 
to control the read/record mechanism. Complete details are given in 
Appendix C. 


LOAD 


Causes a tape (magnetic or paper) that was previously "Saved" to be 
loaded into memory. It clears out the present memory (if any) before 
starting. Complete details are given in Appendix C. 


APPEND 


Works exactly like LOAD, but does not clear out present contents of 
memory. 


CONTROL C a, 


Pressing the Control C key on the terminal console will cause BASIC 
to halt its current operation and to respond with a READY. BASIC will 
then accept further commands. This command is often used to stop a LIST 
command before it has completed or to halt the execution of a looped pro- 
gram. Due to the use of a PIA on the control interface, the user may have 
to type Control C several times. 


CONTROL X 


Clear the current line buffer. If the user types a line at the termi- 
nal and decides that the line is in error and should be deleted, a simultan- 
ous depression of the Control and X keys before the carriage return will 
clear the line. The system responds with "DELETED" and a CR and LF. 


CONTROL _O 


Single character backspace. If a character is determined to have 
been typed in error, it may be deleted by simultaneously pressing the 
Control and O keys, then entering the correct character. A _is echoed 
to signify the backspace. You may backspace as many character positions 
as necessary. BASIC will prevent you from backing past the start of the 
line. 


PATCH 


Causes the computer to return to the ite acting system and 
outputs a Carriage Return, Line Feed and 'k' on the print device. If no 
BASIC memory and the program counter addresses (A@48 and AG49) are not 
changed, typing a G for "Go to User Program" will restart the program with 
the User program intact. The PATCH command may even be inserted as a con- 
trol statement within a BASIC user program. When the PATCH statement is 
encountered, control is transferred to Mikbug ®and the computer outputs 
a Carriage Return, Line Feed and '*'. Typing a G retruns control back to 
the BASIC user program statement immediately following the PATCH statement. 


TRACE ON 


Prints each Line number as the line is executed. A debugging tool! 


mrxpuc™ is a registered trademark of Motorola, Inc. 
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TRACE OFF 
Stops the "TRACE" function. 
LINE 
Specifies the number of print positions in a line (Line Length). 
Example: LINE=65, LINE=80, LINE=40 


Note:: Each line is broken up into 16 character "Zones". If the 
print position is within the last 25 percent of the "line" length and a 
"space" is printed, a C/R LF will be output. This is so that a number or 
word will not be split up at the end of a print line. Therefore, if you 
wish to inhibit this (for precise print control) just set "line™ equal to 
greater than 125 percent of your print line length. 


DIGITS 


Sets the number of digits printed to the right of the decimal point, 
This will truncate (not round) any digits greater than the number printed, 
and will force "0O"s if there aren't enough significant digits to fill the 
number of positions specified in the "DIGITS" command. 


DIGITS=0 resets to floating point mode. 
PORT 


PORT=X defines the computer I/O Port which will serve as the ‘Control 
Port’. ‘xX can be a constant, variable, or expression. 


Warning - If you define a Port without a terminal as the Control Port, 
all messages (including the "Ready") will be inputed and outputed from that 
Port...therefore you will lose control of your program! 


Note: Interrupts are not allowed. PIA PORTS require handshaking. If hand- 
shaking is not available, then you must use the "PEEK" command to examine 

the PIA Registers. Also, BASIC will always accept a break from port l; therefore 
never leave port 1 without either a terminal connected. - 


PORT TYPE OF PORT 


ACIA 
MODIFIED PIA (CONTROL PORT) 
ACIA 


PIA 
PIA (LINE PRINTER, BY CONVENTION 
SWIPC PR-40) 


NWO WN FE O 
> 
e 


POKE 


POKE (I,J) takes the decimal value of "J" and places it in the decimal 
memory location "I'', WARNING - Exercise great care in the use of this 
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command, as it is easy to bomb the basic interpreter, your program, and/ 
or your data! 


DIRECT EXECUTION - CALCULATOR MODE 


BASIC facilitates computer utilization for the immediate solution of 
problems, generally of a mathematical nature, which do not require itera- 
tive program procedures. To clarify: BASIC may be used as a sophisticated 
electronic calculator by means of its "direct" (no statement number) state- 
ment execution capability. 


While BASIC is in the command mode some BASIC statements may be 
entered without statement numbers. BASIC will immediately execute such 
statements. This is called the direct mode of execution. Example: 


PRINT (28 + 3.75) * 2.317 


Statements that are entered with statement numbers are considered to 
be program statements which will be executed later. 


In the following sections of this manual all BASIC statements are 
described. Only those statements which are flagged with the word ‘Direct! 
may be used in the direct mode. 


Another use for direct execution is as an aid in program development 
and debugging. Through use of direct statements, program variables can 
be altered or read, and program flow may be directly controlled. 
DIM var (exp) or var (exp) .var(ex or var(exp,ex 

The DIM statement allocates memory space for an array. In this ver- 
sion of BASIC, one or two dimension arrays are allowed. Maximum array size 


is 255 x 255 elements. All array elements are set to zero by the DIM state- 
ment. 


If an array is not explicitly defined by a DIM statement, it is assumed 
to be defined as an array of 10 elements (or 10 X 10 if two elements are 
used) upon first reference to it in a program. 

Caution: An array can be determined only once in a program, implicitly 
and explicitly. Also only the variables A thru Z (followed by 
$)may be dimensioned for strings. 


Example: DIM A(10), C(R5+8), D(30,A*3), A7(20), C$(30), z$(5) 
but not A6$(5) 


DATA num [num,..num] 
READ var [var,..,var] 
RESTORE 


The DATA and READ statements are used in conjunction with each other 
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as one of the methods to assign values to variables. Every time a DATA 
statement is encountered, the values in the argument field are assigned 
sequentially to the next available position of a data buffer. All DATA 
statements, no matter where they occur in a program, cause DATA to be com- 
bined into one list. 


READ statements cause values in the data buffer to be accessed sequen- 
tially and assigned to the variables named in the READ statement. They 
start with the first data element from the first data statement, then the 
second element, to the end of the first data statement, then to the first 
element of the second data statement, etc., each time a READ command is 
encountered. If a READ is executed, and the DATA statements are out of 
data, an error is generated. 


Numeric and string data may be intermixed, however it must be called 
in the appropriate order. 


Note: String data need not be enclosed within quotes (") as the comma (,) 
acts as the delimiter. However, if the string contains a (,), then 
it must be delimited by quotes ("). Example: 


10 DATA 10,20,30,56.7,"TEST, ONE",1.67E30,8,HELLO 
20 READ A,B,C,D,E$,F,G5,F$ 


Note: DATA STATEMENTS may be placed anywhere within the program. 


Example: 110 DATA 1,2, 
120 DATA 4.5, 
130 DATA 80,8 
140 READ B,C, 


25325 
537370 

1 

DE 

Is the equivalent of: 


10 LET B=1 
20 LET C=2 
30 LET D3. 
40 LET E=4. 


The RESTORE statement causes the data buffer pointer, which is advanced 
by the execution of READ statements, to be reset to point to the first 
position in the data buffer. 


Example: 110 DATA 1,2,3.5 
120 DATA 4.5,7,70 
130 DATA 80,81 
140 READ B,C 
150 RESTORE 
160 READ D,E 


In this example, the variables would be assigned values equal to: 


NRNE 


100 LET 
101 LET 
102 LET 
103 LET 


ou Ww 


Assignment Statements 


LET var=exp (Direct) 


The LET statement is used to assign a value to a variable. 
of the word LET is optional unless you are in the direct mode. 


The use 


100 LET B=827 

110 LET C=87E2 

120 R=(K*Y) /2*A 

130 C$="THIS IS TEXT" .' 


Example: 


The equal sign does not mean equivalence as in ordinary mathematics. 
It is the replacement operator. It says: replace the value of the variable 
named on the left with the value of the expression on the right. The ex- 
pression on the right can be a simple numerical value or an expression 
composed of numerical values, variables, mathematical operators, and 
functions. 


MATHEMATICAL OPERATORS 


The mathematical operators used to form expressions are: 


Exponentiation - Raises to a power 


(unary) ...66- 


woos erereseeese 


Negate (Requires only one operand) 
Multiplication 

Division 

Addition 


1+~nwHe 1 > 


Subtraction 


ee ey 


mathematical operators may appear in sequence, and no operator 
AB and (At2) (B-3) are not valid. Exception: A -3 is- 


No two 
is ever assumed: 
allowed. 


PRIORITY OF OPERATIONS 


1. Exponentiation Ct) 
2. Negation (-) 
3. Multiplication (*) and Division (/) 
4. Addition (+) and Subtraction (-) 


The expression is evaluated left to right in the above priority sequence 
unless parenthesis are encountered (the operators within the parenthesis 
are evaluated first, utilizing the above priority structure.). Example: 


A=2 
Be3 
c=4 


B=C/2=5 
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Bt 2+C/At2=10 oF 


Ct2-C/A=14 
fk CAt Bt 2) -2220 
AtATB=s 64 


STRING CONCATENATION 


Although any one string variable may be a maximum of 18 characters 
long, strings may be concatenated (joined) up to a maximum of 128 characters 
(for printing). The concatenation symbol is the "+". 


Example: A$=""HELLO" 
BS=""JOHN" 
CS=AS+BS 
cS$="HELLOJOHN" 


Control Statements 


Control statements are used to control the natural sequential progres- 
sion of program statement execution. They can be used to transfer control 
to another part of a program, terminate execution, or control iterative 
processes (loops). 


FOR var=expl TO exp2 STEP exp3 


NEXT var 


The FOR and NEXT statements are used together for setting up program 
loops. A loop causes the execution of one or more statements for a speci- 
fied number of times. The variable in the FOR_TO statement is initially 
set to the value of the first expression (expl). Subsequently, the state- 
ments following the FOR are executed. When the NEXT statement is encountered, 
the named variable is added to the value indicated by the STEP expression 
in the FOR_TO statement, and execution is resumed at the statement follow- 
ing the FOR_TO. If the addition of the STEP value develops a sum that is 
greater than the TO expression (exp2) or, if STEP is negative, a sum less 
than the TO expression (exp2) , the next instruction executed will be the 
one following the NEXT statement. If no STEP is specified, a value of one 
is assumed. If the TO value is initially less than the initial value, the 
FOR_NEXT loop will still be executed once. 


Example: 110 FOR I=.5 TO 10 
120 INPUT X 
130 PRINT I,X,X/5.6 
L$) NEXT I 


Although expressions are permitted for the initial, final, and STEP 
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values in the FOR statement, they will be’ evaluated only once, the first 
time the loop is entered. 


It is not possible to use the same indexed variable in two loops if 
they are nested. 


When the statement after the NEXT statement is executed, the variable 
is equal to the value that caused the loop to terminate, not the TO value 
itself. In the example, I would be equal to 9.5 when the loop terminates. 


STOP 


The STOP statement causes the program to stop executing. BASIC re- 
turns to the command mode. The STOP statement differs from the END state- 
ment in that it causes BASIC to display the statement number where the 
program halted, and the program can be restarted by a GOTO or a CONT. The 
message displayed is STOP XXXX. 


END 

The END statement causes the program to stop executing. BASIC returns 
to the command mode. In this version:of BASIC, END may appear more than 
once and need not appear at all, 


GOTO statement n (Direct) 


The GOTO statement directs BASIC to execute the specified statement 
unconditionally. Program flow continues from the new statement. 


Example: 150 GOTO 270 
GOSUB__statement n 


A subroutine is a sequence of instructions which perform some task 
that would have utility in more than one place in a BASIC program. To 
use such a sequence from more than one place, BASIC provides subroutines 
and functions. 


A subroutine is a program unit that receives control upon execution 
of a GOSUB statement. Upon completion of the subroutine, control is re- 
turned to the statement following the GOSUB by execution of a RETURN state- 
ment. 


A function is a program unit to which control is passed by a reference 
to the function name in an expression. A value is computed for the function 
name, and control is returned to the statement that invoked the function. 


GOSUB statement n 


statement n 
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RETURN 


The GOSUB statement causes control to be passed to the given state- 
ment number. It is assumed that the given statement number is an entry 
point of a subroutine. The subroutine returns control to the statement 
following the GOSUB statement with a RETURN statement. 


Subroutine 

Example: 100 X=1 
110 GOSUB 200 
120 PRINT X 
125 X=5.1 
130 GOSUB 200 
140 PRINT X 
150 STOP 
200 X=(X+3) *5.32E3 
210 RETURN 
211 END 


Subroutines may be nested; that is one subroutine may use GOSUB to 
call another subroutine which in turn can call another. Subroutine nest- 
ing is limited to eight levels. 


ON EXP GOTO statement n m,...L 


ON _EXP GOSUB statement n, (m,...L 

This statement transfers control to the statement or subroutine as 
defined by the value of exp. The expression will be evaluated, truncated 
(chopped off after the decimal point) and control then transferred to the 
nth statement number (where n is the integer value of the expression). 


Example: ON N GOTO 110,300,500, 900 
Means: If N<l You will get an error 
If N=1 GOTO 110 
If N=2 GOTO 300 
If N=3 GOTO 500 


If N=4 GOTO 900 
If N>4 You will get an error 


Example: ON (N+7)*2 GOSUB 1000, 2000 
(see GOTO and GOSUB) 

IF relational exp THEN statement n 

IF relational exp THEN BASIC statement (Direct) 


The IF statement is used to control the sequence of program statements 
to be executed, depending on specific conditons. If the relational expres— 
sion given in the IF is "true", then control is given to the statement 


s— 


number declared after the THEN. If the relational expression is "false", 
program execution continues at the statement following the IF statement. 


It is also possible to provide a BASIC statement after the THEN in 
the IF statement. If this is done, the relational expression is true, 
the BASIC statement will be executed and the program will continue at the 
statement following the IF statement. 


When evaluating relational expressions, arithmetic operations take 
precedence in their usual order, and the relational operators are given 
equal weight and are evaluated last. 


Example: 5+6*5>15*2 evaluates to be true 


as 


The Relational Operators 


= Equal 

Not Equal 

Less Than 

Greater Than 

Less Than or Equal 
Greater Than or Equal 


< 


Vv 


A 
wnvia 


Vv 


Examples: 110 IF A B+3 THEN 160 > 
180 IF A=B+3 THEN PRINT "VALUE A", A 
190 IF A B THEN T1=B 


Input/Output Statements 


Any INPUT or PRINT statement may be followed with a "#N" where "N" is 
the input or output port number (f-7). "N" may be a constant, variable or exp. 


The default option (no "#N" specified) is PORT#1, the control port. 
(Or as specified with the PORT statement) - a comma (,) must follow the 
port number if anything follows the command. 
Example: INPUT #3,A 


PRINT #7 ,"TEST" 
PRINT #7 


INPUT var (var... ,var) 


The INPUT statement allows users to enter data from the terminal during 
program execution. 


Example: INPUT X - Inputs one numeric value 
INPUT X$ - Inputs one string value 


==. 


INPUT X,Y,Z,B$ - Multiple Inputs may be entered, seperated 
by ",". If the expected number of values 
are not entered, another "?" will be 
generated. 
INPUT#2,x - Inputs a value from Port #2. 
INPUT "ENTER VALUE,X - Prints the message in quotes, then 
a "2", and waits for input. It stores 
the inputed value in X. 


When the program comes to an INPUT statement, a question mark is dis- 
played on the terminal device. The user then types in the requested data 
separated by commas and followed by a carriage return. If insufficient 
data is given, the system prompts the user with '?'. If no data is entered, 
or if a non-numeric character is entered, the system prompts "RE-ENTER", 
however, for string variables a null return will be consideres as valid 
data. Caution: for input A$,B$,C$ - a null response would create three 
null variables. Only constants can be given in response to an INPUT statement. 


PRINT var (Direct 


PRINT "textstring" (Direct) 
PRINT ex (Direct) 


The PRINT statement directs BASIC to print the value of expression, 
literal values, simple variables, or text strings on the user's terminal 
device. The various forms may be combined in the print list by separating 
them with commas or semicolons. Commas will give zone spacing of print 
elements, while semicolons will give a single space between elements. If 
the list is terminated with a semicolon, the line feed/carriage return will 
be suppressed. 


1. PRINT - Skips a line. 

2. PRINT A,B,C - Prints the values of A, B, and C, separated into 
16 space zones. Use of a ";" in place of the "," 
would print A,:B, and C separated by one space. 
(No space is generated if a string variable.) A 
C/R, LF is generated at the end of the line. 

3. PRINT "LITERAL STRING" - Prints the characters contained within 

the quotes 

4. PRINT#7,A,B;"LITERAL" - Prints variables A & B and the word 

"LITERAL" to PORT #7 (the line printer, 
by convention). 


The TAB Function 


The TAB function is used in the PRINT statement to cause data to be 
printed in exact locations. TAB tells BASIC which position to begin print- 
ing the next value in the print list. The argument of TAB may be an ex- 
pression. 


Example: 110 PRINT TAB(2) ,B,TAB(2*R) ,CS$ 


f 
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Note: The PRINT positions are numbered one to 72. 


Functions 


RND 


RND(X) produces a set of uniformly distributed pseudo-random numbers. 
If "x" (the seed) is 0, then each time RND(X) is accessed a different num- 
ber between 0 and 1 will be returned. If "X"<>0, then a specific random 
number will be returned each time (the same number each time). RND can be 
called without an argument, in which case it works as if one had used an 
argument of @. 


If you require random numbers other than between 0 and 1, then: 
"PRINT INT( (B-At) *RND(0) +A)" 
L 

will yield random numbers ranging between A & B. 
TAB 

TAB(X) will move the print position to the "Xth" position to the right 
of the left margin. If the print position is already to the right of the 
position specified in the TAB command, no spaces will be left and printing 
(if any) will commence. 
Note: The first print position (left margin) is position #1. 
INT 

INT(X) returns the greatest integer less than X. 


Example: INT&.354)=4 
Now Note this one: INT(-4.354)=-5 


ABS 
ABS(X) returns the ‘Absolute Value" of X. 
Example: ABS(3.44)=3.44 
ABS (-3.44)=3.44 
SGN 
SGN(X) returns the 'sign' (+,-,or)) of X. 
Example: SGN(4.5)=1 
SGN(-4.5)=-1 
SGN (0) =0 
SGN (-0) =0 
POS 


Returns the present position of the printhead. (In effect the inverse of 
TAB) , 
Example: PRINT TAB(I) ;X; 
IF POS>)=71 THEN PRINT 
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LEN(X$) returns the number of characters contained in x$. 


- Example: LEN("TESTING")=7 
LEN("TEST ONE") =8 


Note: The space does count! 


Note: LEN(STRS$(X)) = The number of print positions required to print the 
number X. 


ASC (string or string variable) returns the decimal ASCII numeric value of 
the first ASCII character within the string, .. 


Example: ASC("?")=63 : 2 
ASC(""A") =65 R= 7s 
ASC ("B") =66 PS ees 
ASC("Z") =90 ak ek 
ASC("5")=53 Fo FY 


LET BS="'5"—>> ASC(BS) =53_ 


CERS. 


CHRS$(X) returns a single character string equivelent to the decimal 
ASCII numeric value of X. This is the inverse of the ASC function. 


Example: CHR$(63)="2" 


CHR$ (65) ="A" 
CHR$(66)="B" 
CHR$(53)="5" 


VAL 
VAL(X$) returns the numeric constant equivelent to the value in xs. 
This is the inverse of the STR$ function. 


Example: VAL("12.3")=12.3 
VAL("5E4")=5000 
VAL ("TWO") =GENERATES AN ERROR. 
VAL("-12.3")=-12.3 


STR$ 


STR$(X) returns the string value of a numeric value. This is the 
inverse of the VAL function. 


Example: A=34567 


LET AS=STR$ (A) 
A$ NOW EQUALS "34567" 
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LEFTS 


LEFT$(X$,N) returns a string of characters from the leftmost to the 
Nth characters in X$. 


Example: XS$="0NE,TWO,THREE" 
LET AS=LEFTS (XS, 6) 
AS NOW EQUALS "ONE,TW" 


RIGHT 


RIGHT$(X$,N) returns a string of characters from the Nth position to 
the left of the rightmost character, through the rightmost character. 


Example: X$="ONE,TWO, THREE" 
AS=RIGHTS (X$ , 9) 
A$ NOW EQUALLS “TWO, THREE" 


MIDS. 


MIDS (xX$,X,Y) returns a string of characters from X$ beginning with the 
Xth character from the left, and continuing for Y characters from that 
point. Y is optional. If Y is not specified, then the string returned is 
from the Xth character to the right of the beginning (left side) of the 
string through the end of the string. 


Example: X$=""0NE,TWO,THREE" 
AS=MID$ (X$ , 3, 10) 
AS NOW EQUALS "E,TWO,THREE" 
PEEK 


PEEK(X) returns, in decimal, the value contained in (decimal) memory 
location X. 


Example: LET A=PEEK(255) 
A will now contain the decimal value contained in memory location 25519: 
POS 
POS returns, in decimal, the current position of the print head or 


cursor. The first position (left margin) is position #1. 


Mathematical Functions 


Function Interpretation 

SIN(X) Returns the SINE of X 

COS (X) Returns the COSINE of X 

TAN (X) Retruns the TANGENT of X 

LOG(X) Returns the NATURAL LOGARITHM of X 
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EXP (X) Returns the base of NATURAL LOGARITHMS raised to the 
Xth power (this is the inverse of LOG(X).) 
SQR(X) Returns the SQUARE ROOT of X 


Note: For these TRANCENDENTAL FUNCTIONS ONLY, the accuracy is stated to 
seven (7) significant digits, and the accuracy of the seventh digit, 
or 1E-7 (whichever is greater) is not guaranteed! 


Note: For SIN, COS,& TAN the argument is in radians (not degrees). 
USER 


LET A=USER(X) transfers program control to a USER-written machine 
language program. Program control branches to the memory location pointed 
to by memory location $67 and $68. X is a numeric expression which is then 
stored in a 7 byte series beginning at a memory location pointed to by 
$5D and $5E (this value may be modified by the USER-written machine language 
program to act as a "Data Output! from the program, or as an indicator that 
“gomething was done"). The USER program must terminate with a $39, thereby 
transferring program control back to the BASIC interpreter. Additionally, 

A is now set equal to the value stored in the 7 byte series stored in a 
memory location pointed to by $5D and $5E. ($67 denotes hex location $$67) 


Note that when BASIC is loaded, memory locations $67 and $68 point to 
a location containing $39, so the USER function will just return control 
to the BASIC interpreter. You will have to modify memory locations $67 and 
$68 using the POKE or PATCH command in order to use this function. 


Warning: It would be easy to inadvertantly modify the BASIC interpreter, 
its program, and/or its data using this function. Make sure 
you understand the machine level implications before using it!! 
Also, note that if your USER-written machine language program 
does not end with a $39 (RTS), your function will Bomb, your 
program will Bomb and BASIC will Bomb --- All is Lost! 


DEF FN(X 
DEF FN LETTER (VARIABLE) = EXPRESSION 


This function allows the user to create his very own functions. The 
LETTER ig any alphabetic character. This names the function (I.E. you 
could have, say, three functions named FNA, FNB, and FNC). The VARIABLE 
is a Non-Subscripted numeric variable. This is essentially a "dummy" 
variable (or place holder)... This will be apparent shortly. The "Expression" 
is any valid expression. Note that the “variable” must be enclosed within 
parenthesis. 


For example, study the following sample program: 
10 DEF FNA(X)=3.14*x 


20 DATA 5,6,7,0 
30 READ X 
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40 IF X=0 THEN END 
50 PRINT FNA(X) 
60 GOTO 30 


RUN 
78.5 
113.04 
153.86 
READY 


As you can see, the dummy variables were replaced with the variables 
you actually wished to use at the time the function was used. 


Note: You may not define the same function greater than once per program, 
and a function must be defined before it is called. 


COMMANDS 


LIST & 

RUN 

NEW 

SAVE 

LOAD 

PATCH & 
APPEND 
DIGITS & 
LINE & 
CONT & 
PORT & 
TRACE ON & 
TRACE OFF & 


APPENDIX A 


INSTRUCTION SUMMARY 


STATEMENTS 
REM END 
DIM* GOTOX 
DATA ON. . ,GOTO* 
READ ON.-. . GOSUB* 
RESTORE IF... THEN* 
LET INPUT 
FOR PRINT* 
NEXT PATCH* 
STOP RETURN 
GOSUB* POKE* 

DEF 


FUNCTIONS 
ABS LEN 
INT ASC 
RND SQR 
SGN EXP 
USER LOG 
TAB VAL 
PEEK CHRS 
SIN STR$ 
Cos LEFTS 
TAN RIGHTS 
FNX MIDS 
POS 


( )* Flags STATEMENTS that may be used in the direct mode (no statement 


numbers) 


( )& Flags COMMAND that may be used in programs 


MATH OPERATORS 


+ Exponentiate = 


RELATIONAL OPERATORS 


Equal 

Not Equal 

Less Than 

Greater Than 

Less Than or Equal 
Greater Than or Equal 


-(unary) Negate <> 

* Multiplication < 

/ Division > 

+ Addition <= 

- Subtraction >= 
Line Numbers - May be from 1 thru 9999 
Variables - May be single character alphabetic or single character 

alphabetic followed by one integer 0 thru 9 or $ 

Backspace - Is a Control 0 


Line Cancel 


Panic Button 


Is a Control X 


Typing a Control C should bring Basic back to the READY 
mode regardless of what the Basic User program is doing. 
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1. Error ¢ in line # 


A. 


APPENDIX B 


ERROR MESSAGES 


If line # = 0000, error wes in direct execution statement 


2. Error Codes 


Oversize variable (over 255) in TAB, CHR, subscript or "on! 
Input error 
Illegal character or variable 
No ending " in print literal 
Dimensioning error 
Tllegal arithmetic 
Line number not found 
Divide by sero attempted 
Excessive subroutine nesting (max is 8) 
RETURN W/O prior GOSUB 
Tilegal variable 
Unrecognizable statement 
Parenthesie error 
Memory full 
Subscript error 
Excessive FOR loops active (max ia 8) 
"Xx" w/o FOR Loop defining |X"! 
Mienested FOR=-NUXT 
READ statement error 
Error in ON statement 
Input Overflow (more than 72 characters on Input line) 
Syntax error in DEF statement 
Syntax error in PN error, or FN called on Function not defined 
Error in STRING Usage, or mixing of numeric and atring variables 
String Buffer Overflow, ox String Extract (in MID$,LEFT§, or 
RIGHTS) too long 
1/0 operation requested to a port that does not have an 1/0 card 
installed 
VAL function error = atring etarte with a non=numeria value, 


’ 
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APPENDIX C - SAVING AND LOADING’ PROGRAMS 


SAVE 

The SAVE command allows the user to dump the current BASIC program 
to either cassette or papep tape. Using the SAVE command is similar 
to the P command of MIKBUG  —- punch on/off commands are automatically 
sent to the recording device. When using a SWIPC AC - 30 cassette in- 
terface either the MANUAL or AUTOMATIC motor control mode can be used. 
Turning the recorder to record and typing a SAVE followed by a carriage 
return will save a copy of the program on tape. The SAVE command dumps 
the entire BASIC buffer to tape - line numbers such as SAVE 10-20 can 
pot be entered to transfer only a portion of the program to tape. The 
program in the buffer that is saved is left intact during a save operation. 


LOAD 

The LOAD command allows for the entering of previously recorded 
BASIC programs through either cassette or paper tape. The LOAD command 
is similar to the L command of MIKBUGR - reader on/off commands are auto- 
matically sent and either MANUAL or AUTOMATIC motor control can be used 
on a SWIPC AC-30 cassette tape interface. Typing LOAD followed by a 
carriage return will transfer the program from tape to the BASIC buffer. 
The buffer is automatically cleared at the beginning of a LOAD command. 


NOTE: The SAVE and LOAD commands assume that the punch/read device 
is set up to decode automatic reader/punch on/off. If your particular 
unit is not automatic the reader or punch should be turned on manually 
before the carriage return is entered after the respective LOAD or 
SAVE command. 


APPEND 
The APPEND command is identical to the LOAD command except that the 
current BASIC buffer is not cleared. 


The SAVE, LOAD and APPEND commands can all be used to work on any 
port. If for example your cassette recording device is on the ACTA 
port three a SAVE #3 command would be used. 
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APPENDIX D 


ASCII Hexadecimal to Decimal Conversion Table 


way > 


2 
a & 
[-4 I 
ge 
oO = (=) 
+ 2B $43 
’ 20 «G44 

2D G45 
: 2E 946 
/ 2F G47 
$ 30 G48 
1 31 049 
2 32 050 
3 33 51 
4 34 952 
5° 35 053 
6 36 954 
7 37 955 
8 38 956 
9 39 057 
: 3A 958 
; 3B 59 
< 3C 960 
= 3D 961 
> 3E 62 
2 3F 963 
@ 40 G64 
A Al 665 
B 42 $66 
Cc 43 467 
D 44 968 
BE 45 969 
F 46 679 
G 47 971 
H 48 §72 
I 49 673 
J 4A 974 
K 4B 975 
L 4 $976 
M 4D p77 
N 4E 978 
O 4F 4979 
P 54 9386 
Q 51 gsr 
R 52 G82 
S 53 4983 
T 54 684 
U- 55 (gas 
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APPENDIX E 


Loading BASIC 


This BASIC interpreter is being made available on both paper and 
cassette tape. Before loading BASIC you must make sure you have at 
least 8K (9$@¢ thru 1FFF) of RAM memory in your computer system. Load 
BASIC from either your SWIPC AC-30 Cassette Interface or paper tape read— 
er just as you would any other program. The tapes supplied will load the 
BASIC interpreter as well as set the program counter addresses AQ48 and 
AG49 to $149, the starting address of the BASIC interpreter. To start 
type G for "Go to User Program". Should for some reason or another you 
depress the RESET button on the front panel of the SWIPC 6800 Computer 
System and wish to re-enter BASIC wihhout losing the program you had 
earlier stored in memory, reset program counter addresses A@48 and AG49 
to $193 and type G. Setting the program counter to @19@ will get you © 
back into BASIC but you will lose any previously entered programs. 


APPENDIX F 

Memory Map 
$600 - GOFF Input buffer and temporary variable storage 
$190 - 1B7F BASIC Interpreter 


1B8¢ - 1C8¢ . Arithmatic and FOR - NEXT stack 


Useful Locations | 


$944 — $645 Memory limit 
OG2A -— G92B Contains the next available memory location- 
after the BASIC program 
~$2E - G@2F Contains the start of BASIC program 
0646 - 9947 Contains the next available memory location 
after BASIC and any defined variables 
@O5D - $O5E Contains the address of the present arithmatic 
value in use during a USER call 
$967 - $668 Contains the pointer for USER 
$196 Hard start address 
9193 Soft start address 
Notes: l. The last 256 bytes of memory available are used as a string 


expression buffer and for the machine stack. ‘ 


2.  A@4A - AGFF is-used as an index register stack. 
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APPENDIX G 


Notes for Speeding up BASIC 


Subscripted variables take considerable time; whenever possible 
use non-subscripted variables. 


Transcendental functions (SIN, COS, TAN, EXP, LOG) are slow because 
of the number of calculations involved, so use them only when 
necessary. Also the *. operator uses both the LOG and the EXP 
functions, so use the format A*A to square a number. 


BASIC searches for functions and subroutines in the source file, 
so place often called routines at the start of the program. 


BASIC searches the symbol table for a referenced variable, and 
variables are inserted into the symbol table as they are referenced, 


therefore reference a frequently called variable early in the pro- 
gram so that it comes early in the symbol table. 


Numeric constants are converted each time they are encountered, 
so if you use a constant often, assign it to a variable and use 


the variable instead. 


APPENDIX H 


Notes on Memory Usage in BASIC 


REM statements use space, so use them sparingly. 

Each non-subscripted numeric variable takes 8 bytes. 

Each non-subscripted string variable takes 20 bytes. 

Each numeric array takes 6 bytes plus 6 bytes for each element. 
Each string array takes 6 bytes plus 18 bytes for each element. 


An implicitly dimensioned variable creates 10 elements (or 10 by 
10). %If you do not intend to use all 10 elements, save memory 
by explicitly dimensioning the variable. 


Each BASIC line takes 2 bytes for the line number, 1 byte for the 
the encoded key word, 1 byte for the end of line terminator, plus 
one byte for each character following the key word. Memory can be 
saved by using as few spaces as possible. 


BASIC reserves the uppermost 256 bytes of memory for stack and 
buffer use. 
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AUTHOR'S NOTE: 


At the commencement of writing 8K BASIC, the target I set for 
myself was to ensure that 8K BASIC would meet the proposed minimum 
standards for BASIC established by ANSI Committee X3J2. 


In fact, 8K BASIC goes considerably beyond the minimum, in 
specific, all the string functions, the string arrays, the nine dig- 
it accuracy, etc. are considerable expansions of the minumun. 


However, there is one instance where I could not see eye to eye 
with the committee. This is with regards to subscripts in arrays 
(which, by the way, is where the committee had their greatest argument). 
ANSI proposed a minimum subscript of 9, with a statement of "OPTION 
BASE 1" changing this to a minimum of 1. 


I feel that: 
Zs Most users will not put in the option statement. 


2. The beginning user will only have a subscript of 
@ when he makes an error. 


3% For a micro-computer, this is very wasteful of space. 


Therefore, I have taken an author's privilege and forced a base 
of 1 in all cases. 


This means that SWIPC 8K BASIC does not conform to the ANSI stand- 
ard. If those reading this strongly disagree with me, write me and 
I will consider changing this in later versions of 8K BASIC. 


Finally, I would like to thank the following persons, without 


whom BASIC would have taken far longer: Jim Stratigos, Jeff Harrow, 
Jim Hansen and Joe Deres. 


Robert H. Uiterwyk 
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